---
title: "Get Chat Conversations"
api: "GET https://api-v2.opencopilot.so/backend/chat/{organization_id}"
description: "Retrieve paginated chat conversations, including handoff status and sentiment summary."
---

This endpoint allows you to retrieve all conversations for a specific Organization ID. The response includes the conversation id, sentiment, and reason for handoff (if applicable).

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication
</ParamField>

## Path Parameters

<ParamField path="organization_id" type="string" required>
  The unique identifier of the organization
</ParamField>

## Query Parameters

<ParamField query="page" type="integer" default="1">
  The page number to retrieve
</ParamField>

<ParamField query="limit" type="integer" default="10">
  The number of items to retrieve per page
</ParamField>

<ParamField query="sortBy" type="string" default="created_at">
  The field to sort by
</ParamField>

<ParamField query="sortDirection" type="string" default="ASC">
  The direction to sort (ASC or DESC)
</ParamField>

## Response

<ResponseField name="id" type="string">
  The unique identifier for the chat conversation
</ResponseField>

<ResponseField name="copilot_id" type="string">
  The unique identifier for the organization (copilot) associated with the conversation
</ResponseField>

<ResponseField name="created_at" type="string">
  The date and time the conversation was created
</ResponseField>

<ResponseField name="channel" type="string">
  The channel on which the conversation was created (whatsapp, email, web, or phone)
</ResponseField>

<ResponseField name="summary" type="string">
  A summary of the conversation (only available for conversations marked as handoff)
</ResponseField>

<ResponseField name="classification" type="string">
  The classification of the conversation (based on the user's provided categories and tags)
</ResponseField>

<ResponseField name="assignee_id" type="string">
  The ID of the assignee for the conversation
</ResponseField>

<ResponseField name="handoff" type="boolean">
  Indicates whether the conversation was handed off to a human agent
</ResponseField>

<ResponseField name="handoff_sentiment" type="string">
  The sentiment of the conversation at the time of handoff
</ResponseField>

<ResponseField name="status" type="string">
  The status of the conversation (open, resolved, or closed)
</ResponseField>

<ResponseField name="meta" type="object">
  Metadata about the conversation (such as title, recording URL, and phone number)
</ResponseField>

<ResponseField name="action_called" type="integer">
  The number of actions called during the conversation
</ResponseField>

<ResponseField name="total_messages" type="integer">
  The total number of messages in the conversation
</ResponseField>

<RequestExample>

```bash Example Request
curl --location 'https://api-v2.opencopilot.so/backend/chat/your-organization-id' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json'
```

</RequestExample>

<ResponseExample>

```json Response
[
  {
    "id": "5003584a-be1f-4754-a0c7-703f48589e03",
    "copilot_id": "4ef0737b-976a-450e-8188-4f1f5a1a1b0b",
    "created_at": "2024-06-03T11:57:48.000Z",
    "channel": "web",
    "summary": "The customer is dissatisfied with the product and is looking for a refund.",
    "classification": "REFUND_REQUEST",
    "assignee_id": "copilot",
    "handoff": true,
    "handoff_sentiment": "neutral",
    "status": "OPEN",
    "meta": null,
    "action_called": 1,
    "total_messages": 9
  }
]
```

</ResponseExample>